Monitor USDT ERC-20 Wallet Balance with Etherscan and Telegram Notifications

工作流概述

这是一个包含8个节点的中等工作流,主要用于自动化处理各种任务。

工作流源代码

下载
{
  "id": "AlEVIPHR3dMJkYWt",
  "meta": {
    "instanceId": "58e59e36ad4158b4534237c364ed053a36843e3394fa02af59feb8df38262a79",
    "templateCredsSetupCompleted": true
  },
  "name": "Monitor USDT ERC-20 Wallet Balance with Etherscan and Telegram Notifications",
  "tags": [],
  "nodes": [
    {
      "id": "35b62ca1-3603-4dcb-a3b5-77e1325c78f7",
      "name": "Balance Changed?",
      "type": "n8n-nodes-base.if",
      "position": [
        -40,
        0
      ],
      "parameters": {
        "conditions": {
          "boolean": [
            {
              "value1": "={{$json.balanceChanged}}",
              "value2": true
            }
          ]
        }
      },
      "typeVersion": 1
    },
    {
      "id": "dfeef0d5-0bb2-40a1-ae75-51d7caeb9c3d",
      "name": "Balance Changed.",
      "type": "n8n-nodes-base.telegram",
      "position": [
        320,
        -140
      ],
      "webhookId": "a8fa72ce-638b-4245-bcbc-d59948ae1144",
      "parameters": {
        "text": "=🚨 *USDT Balance Change!*

Wallet Address: {{ $json.walletAddress }}

🔴 Previous Balance: {{parseFloat($json.previousBalance)/1e6}} USDT

🟢 New Balance: {{parseFloat($json.currentBalance)/1e6}} USDT",
        "chatId": "< Your Telegram Chat ID >",
        "additionalFields": {
          "parse_mode": "Markdown"
        }
      },
      "credentials": {
        "telegramApi": {
          "id": "Ge3vEXak2MymWtcp",
          "name": "Telegram account"
        }
      },
      "typeVersion": 1
    },
    {
      "id": "ffebdb46-a6f0-4ed8-88ed-75ab427af969",
      "name": "Balance Not Changed.",
      "type": "n8n-nodes-base.telegram",
      "position": [
        320,
        20
      ],
      "webhookId": "a8fa72ce-638b-4245-bcbc-d59948ae1144",
      "parameters": {
        "text": "=Balance Unchanged. USDT balance remained stable.",
        "chatId": "< Your Telegram Chat ID >",
        "additionalFields": {
          "parse_mode": "Markdown"
        }
      },
      "typeVersion": 1
    },
    {
      "id": "049ff717-ba10-4b7f-9f84-9eaaeee902ec",
      "name": "userData",
      "type": "n8n-nodes-base.set",
      "position": [
        -780,
        0
      ],
      "parameters": {
        "options": {},
        "assignments": {
          "assignments": [
            {
              "id": "4455d1e7-a489-4ab6-a526-4fc755db99d0",
              "name": "Your Wallet Address",
              "type": "string",
              "value": "< Wallet Address Paste Here >"
            },
            {
              "id": "3d84deba-8093-42cf-833f-6891db778de7",
              "name": "Your Etherscan Api Key",
              "type": "string",
              "value": "< Etherscan Api Key Paste Here>"
            },
            {
              "id": "971ea723-e3de-4cff-b4e7-5899f3d8fb00",
              "name": "USDT ERC-20 Token Address",
              "type": "string",
              "value": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
            }
          ]
        }
      },
      "typeVersion": 3.4
    },
    {
      "id": "0488f2dd-6b71-4be5-9ce8-cf0763b82990",
      "name": "balanceChecker",
      "type": "n8n-nodes-base.code",
      "position": [
        -280,
        0
      ],
      "parameters": {
        "jsCode": "const staticData = $getWorkflowStaticData('global');

const currentBalance = items[0].json.result;

const walletAddress = $('userData').first().json['Your Wallet Address']

let previousBalance = staticData.previousBalance;

if (!previousBalance) {
  staticData.previousBalance = currentBalance;
  previousBalance = currentBalance;
}

const balanceChanged = previousBalance !== currentBalance;

staticData.previousBalance = currentBalance;

return [{json: {balanceChanged, previousBalance, currentBalance, walletAddress}}];"
      },
      "typeVersion": 2
    },
    {
      "id": "d7b23d5b-b4c5-4d9a-93f9-360ae0d539c7",
      "name": "Sticky Note",
      "type": "n8n-nodes-base.stickyNote",
      "position": [
        -1040,
        -180
      ],
      "parameters": {
        "color": 4,
        "width": 1540,
        "height": 400,
        "content": "## USDT ERC-20 Wallet Balance Tracker
**This workflow** Is a basic concept of integrating your ERC-20 wallet with n8n nodes."
      },
      "typeVersion": 1
    },
    {
      "id": "7c8f0d69-6c37-469c-b466-89a467db9bbd",
      "name": "Check Balance Every 5 Minutes",
      "type": "n8n-nodes-base.cron",
      "position": [
        -1000,
        0
      ],
      "parameters": {
        "triggerTimes": {
          "item": [
            {
              "mode": "everyX",
              "unit": "minutes",
              "value": 5
            }
          ]
        }
      },
      "typeVersion": 1
    },
    {
      "id": "ea603f03-25e0-4c80-90f2-eb5f09e71ad1",
      "name": "Fetch USDT Balance from Etherscan",
      "type": "n8n-nodes-base.httpRequest",
      "position": [
        -480,
        0
      ],
      "parameters": {
        "url": "https://api.etherscan.io/api",
        "options": {},
        "sendQuery": true,
        "queryParameters": {
          "parameters": [
            {
              "name": "module",
              "value": "account"
            },
            {
              "name": "action",
              "value": "tokenbalance"
            },
            {
              "name": "address",
              "value": "={{ $json['Your Wallet Address'] }}"
            },
            {
              "name": "tag",
              "value": "latest"
            },
            {
              "name": "apikey",
              "value": "={{ $json['Your Etherscan Api Key'] }}"
            },
            {
              "name": "contractaddress",
              "value": "={{ $json['USDT ERC-20 Token Address'] }}"
            }
          ]
        }
      },
      "typeVersion": 3
    }
  ],
  "active": false,
  "pinData": {},
  "settings": {
    "executionOrder": "v1"
  },
  "versionId": "7ebf18de-7adf-40dd-99b4-ff8dd1e37f08",
  "connections": {
    "userData": {
      "main": [
        [
          {
            "node": "Fetch USDT Balance from Etherscan",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "balanceChecker": {
      "main": [
        [
          {
            "node": "Balance Changed?",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Balance Changed.": {
      "main": [
        []
      ]
    },
    "Balance Changed?": {
      "main": [
        [
          {
            "node": "Balance Changed.",
            "type": "main",
            "index": 0
          }
        ],
        [
          {
            "node": "Balance Not Changed.",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Check Balance Every 5 Minutes": {
      "main": [
        [
          {
            "node": "userData",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Fetch USDT Balance from Etherscan": {
      "main": [
        [
          {
            "node": "balanceChecker",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  }
}

功能特点

  • 自动检测新邮件
  • AI智能内容分析
  • 自定义分类规则
  • 批量处理能力
  • 详细的处理日志

技术分析

节点类型及作用

  • If
  • Telegram
  • Set
  • Code
  • Stickynote

复杂度评估

配置难度:
★★★☆☆
维护难度:
★★☆☆☆
扩展性:
★★★★☆

实施指南

前置条件

  • 有效的Gmail账户
  • n8n平台访问权限
  • Google API凭证
  • AI分类服务订阅

配置步骤

  1. 在n8n中导入工作流JSON文件
  2. 配置Gmail节点的认证信息
  3. 设置AI分类器的API密钥
  4. 自定义分类规则和标签映射
  5. 测试工作流执行
  6. 配置定时触发器(可选)

关键参数

参数名称 默认值 说明
maxEmails 50 单次处理的最大邮件数量
confidenceThreshold 0.8 分类置信度阈值
autoLabel true 是否自动添加标签

最佳实践

优化建议

  • 定期更新AI分类模型以提高准确性
  • 根据邮件量调整处理批次大小
  • 设置合理的分类置信度阈值
  • 定期清理过期的分类规则

安全注意事项

  • 妥善保管API密钥和认证信息
  • 限制工作流的访问权限
  • 定期审查处理日志
  • 启用双因素认证保护Gmail账户

性能优化

  • 使用增量处理减少重复工作
  • 缓存频繁访问的数据
  • 并行处理多个邮件分类任务
  • 监控系统资源使用情况

故障排除

常见问题

邮件未被正确分类

检查AI分类器的置信度阈值设置,适当降低阈值或更新训练数据。

Gmail认证失败

确认Google API凭证有效且具有正确的权限范围,重新进行OAuth授权。

调试技巧

  • 启用详细日志记录查看每个步骤的执行情况
  • 使用测试邮件验证分类逻辑
  • 检查网络连接和API服务状态
  • 逐步执行工作流定位问题节点

错误处理

工作流包含以下错误处理机制:

  • 网络超时自动重试(最多3次)
  • API错误记录和告警
  • 处理失败邮件的隔离机制
  • 异常情况下的回滚操作